package com.naiterui.ehp.bs.wechat.service;

/**
 * @author zhoupeipei
 * @date 2019-07-03 18:03
 * @since 1.0.0
 */
public interface IMediaApiService {

    /**
     * 上传临时素材
     * 媒体文件在微信后台保存时间为3天，即3天后media_id失效
     * <p>*图片（MediaApiServiceImpl.MEDIA_TYPE_IMAGE）: 2M，支持PNG\JPEG\JPG\GIF格式</p>
     *
     * <p>*语音（MediaApiServiceImpl.MEDIA_TYPE_VOICE）：2M，播放长度不超过60s，支持AMR\MP3格式</p>
     *
     * <p>*视频（MediaApiServiceImpl.MEDIA_TYPE_VIDEO）：10MB，支持MP4格式</p>
     *
     * <p>*缩略图（MediaApiServiceImpl.MEDIA_TYPE_THUMB）：64KB，支持JPG格式</p>
     * @param type
     * @param filePath 图片资源相对路径
     */
    String uploadTempMedia(String type, String filePath);

    /**
     * 下载临时素材【图片、语音、缩略图，视频在getTempVideoUrl获取下载地址】
     * @param mediaId
     *
     * @return
     */
    byte[] downloadTempMedia(String mediaId);

    /**
     * 获取临时素材-视频文件下载地址</p>
     *
     * @param mediaId
     *
     * @return
     */
    String getTempVideoUrl(String mediaId);

    /**
     * 上传永久素材
     * <p>*图片（MediaApiServiceImpl.MEDIA_TYPE_IMAGE）: 2M，支持PNG\JPEG\JPG\GIF格式</p>
     *
     * <p>*语音（MediaApiServiceImpl.MEDIA_TYPE_VOICE）：2M，播放长度不超过60s，支持AMR\MP3格式</p>
     *
     * <p>*视频（MediaApiServiceImpl.MEDIA_TYPE_VIDEO）：10MB，支持MP4格式</p>
     *
     * <p>*缩略图（MediaApiServiceImpl.MEDIA_TYPE_THUMB）：64KB，支持JPG格式</p>
     * @param type
     * @param filePath 图片资源相对路径
     * @return 素材id
     */
    String uploadMedia(String type, String filePath);

}
